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I INTRODUCTION TO SAGE CP/M-68K 

Welcome to CP/M-68K and the SAGE computer. CP/M-68K is a product of 
Digital Research and has long been available on 8-bit machines, 
specifically the Z80. Digital Research is an eight year old company in 
Pacific Grove Ca. Their users include over 800,000 systems, 700 OEMs 
and 600 independent software houses. 

CP/M-68K is the version of CP/M for the Motorola MC68000 family of 
microprocessors. It is a high performance single-user, single-tasking 
operating system. 

CP/M-68K features a flexible application program interface and powerful 
system utilities combined with a C compiler to provide a complete 
software development environment. 

The major features of CP/M-68K are: 

CP/M and CP/M-86 Compatibility 

Supports from 64 Kilobytes to 16 Megabytes of RAM 

Support for 1 to 16 logical Disk Drives of up to 512 M bytes each. 

C Language 

Sophisticated Software Development Tools 
Standard CP/M Utilities 
Multiple Programs can Co-exist in Ram 
Resident System Extensions 

Allows full access to MC68000 hardware features 

Cross Development tools. 

The package includes a C compiler and run-time library which are subset 
compatible with UNIX Version 7. This provides a bridge from UNIX to 
CP/M-68K. C programs which were developed under the UNIX operating 
system can easily be transported to run under CP/M-68K. 
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II INSTALLATION 



The SAGE boot program resides in PROM and is the same for all operating 
systems. Refer to the detailed instructions in the section on 
INSTALLATION in Volume 1 of the SAGE Users' Manual to unpack your 
computer, connect your terminal and get it ready to power up. 

Briefly: on power up, the screen should display: 

< . — - 

Sage II Startup Test 
RAM SIZE = xxx K 

Booting from Floppy 

Put in BOOT disk and press a key (Q for quit) 

„„___,__,__ ______ ' 



To boot from a floppy, Sw5 of GROUP-A should be up, Sw6 should be down. 

Put the BOOT floppy for CP/M in the left-hand drive. Once you press a 
key, the machine will boot to the command line of CPM. This is a simple 
prompt : 

A> 



If "Not BOOT disk" is displayed, you have the diskette in wrong or it is 
not the correct diskette. Diskettes go in with the label up. 
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11.01 BACKING UP SYSTEM FILES 

Keeping back-up copies of your files is one of the first things a 
programmer learns, usually the hard way. Losing your only copy of a 
day's work is painful. Having to re-type in even an hour of changes is 
valuable time lost. 

The first thing you, as a new user of a SAGE II, must do is backup the 
diskettes that SAGE sent you. These diskettes are write protected and 
cannot be written to. We suggest that the user make a set of working 
system masters which are configured for his system, and then use them to 
generate system diskettes for everyday usage. This means: 

1. Format your blank diskettes for your drives. The disk format 
defines how the data is stored on the diskette. It is 
slightly different for different disk drives and systems. 
For example, on the SAGE II, diskettes can be formatted for 
either 40 track or 80 track drives. Brand new diskettes must 
always be formatted for your drives. 

2. Copy system files to the new formatted diskettes. ALL files 
are copied to the diskette. 

3. Check the new diskettes to make sure they work. Store the 
original diskettes in a safe place away from extremes of 
temperature, dust, and stray magnetic fields. 

These operations will now be described in detail. 
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11.02 FORMATTING A DISKETTE 

Your system diskette should be in the left-hand drive (A) 
Your new diskette should be in the right-hand drive (B) 

Note that the system diskette can be removed to prevent 
formatting the wrong diskette by mistake and losing your 
system data. 

The screen prompts: You type: 



A> SAGEUTIL <CR> 

C(onfigure, B(oot Copy, F(ormat, Q(uit F <cr> 

Floppy Diskette Formatter 

Drive to be formatted (A or B)? B <cr> 

Is diskette ready for formatting in drive B? Y <cr> 



Verification 



Format complete 

More diskettes to format? Y if more 

N if done 



C(onfigure, B(oot Copy, F(ormat, Q(uit Q 
Now you should be back at the "A>" prompt line. 

Note that your should format enough diskettes to backup all of the 
system masters sent with your order and also a few extra for work disks. 
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11.03 COPYING DISTRIBUTION DISKETTES 

Now that you have formatted diskettes, copy the distribution diskettes: 



The screen shows: You type: 

A> COPY 

MODE FUNCTION 
ALL Copy the whole disk 
BOOT Copy the Boot tracks 
FILES Copy the non-boot tracks 
END End this program 
A> 

Enter SOURCE drive_ 
Enter DESTINATION drive_ 
( A C TO ABORT) 

RETURN to copy ALL from A to B 
*** COPYING TRACKS *** 
xx 

Do you wish to repeat the copy? 



ALL 

A 

.«••••••• B 

<cr> 



Put in another master 
and another formatted 
diskette. Type Y to 
copy. 



Repeat until all of the master diskettes are copied. Type "N" to the 
last question. Now you should be back at the "A>" prompt: 
A> 

Note that this method makes a complete copy of the image of the left 
diskette on the right diskette. The bootstrap area will be copied. 

11.04 CHECKOUT OF NEW SYSTEM DISKETTE 



1. Remove both diskettes. 

2. Put the new system diskette in the left side (A). 

3. RESET the computer. 

4. Your system should boot to the "A>" prompt. 
(See the Power-up section). 
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11.05 SAGE IV CP/M-68K INSTALLATION 



SAGE IV CP/M-68K INSTALLATION 



Installation of CP/M-68K on a Winchester partition involves several 
steps. You will first have to boot up in the p-system so partitions for 
CP/M can be added. Put the new partitions into FORMATINFO .TEXT file. 
The distribution diskettes are set up for C: on Partition 5, D: on 
Partition 6 and F: on Partition 7. The CP/M partitions should not be 
less than 2048 blocks. Once the partitions are put into FORMATINFO. TEXT 
run WFORMAT as described in the SAGE IV - USERS' MANUAL SUPPLEMENT in 
section RUNNING WFORMAT so the device maps can be updated. When the 
device maps are updated reformat the CP/M partitions. 

Once the above steps are done boot from the CP/M-68K SAGE IV distibution 
diskette. Now run SAGEAUTL; a more detailed explaination of SAGE4UTL 
will be given later. 

SAGE4UTL is started by typing "SAGE4UTL" from the CP/M-68K prompt: 
A> 

The system now displays: 



SAGE Computer System Utility Package - Version X.X 

A - On-line Configuration 

B - BIOS file Configuration 

C - Floppy Formatter 

D - Bootstrap Copy 

E - Prepare Drives for Shipping 

Select Menu item <CR exits>: 



Typing a 'B' at the outer level prompt line will cause the utility to 
enter the BIOS file Configuration Manager and ask: 

Enter BIOS file? 

You should then enter A: SAGEBIOS .SYS . If the read was successful the 
system now displays: 



A 
C 
E 
G 
I 
K 



Terminal 
Left Floppy 
Ram Disk 

Extra Serial Port #1 
Extra Serial Port #3 
Parallel Port 



B - Remote 

D - Right Floppy 

F - Printer 

H - Extra Serial Port #2 
J - Extra Serial Port #4 
L - Low Level Configuration 



Select Menu item <CR exits>: 
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Now type 'L' to enter the Low Level Configuration where the system 
displays : 

Low Level Configuration 
A - BIOS Channel Map (0 to 15) 
B - BIOS Channel Map (16 to 31) 
C - Left Floppy Details 
D - Right Floppy Details 
E - Shared Floppy Details 
F - Winchester #1 
G - Winchester #2 
H - Winchester #3 
I - Winchester #4 
J - Operating System Information 

Select Menu item <CR exits>: 

There are certain channels for each CP/M drive and they are assigned as 
follows: 



Channel 



4 
5 
9 
17 
0 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 



Drive 



A 
B 
C 
D 
E 
F 
G 
H 
I 
J 
K 
L 
M 
N 
0 
P 



Floppy 
Floppy 
Hard Disk 
Hard Disk 
Ram Disk 
Hard Disk 
Hard Disk 
Hard Disk 
Hard Disk 
Hard Disk 
Hard Disk 
Hard Disk 
Hard Disk 
Hard Disk 
Hard Disk 
Hard Disk 
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The BIOS Channel Maps will have to be changed to reflect these channel 
assignments. First type 'A' to enter BIOS Channel Map (0 to 15), the 
system will display: 

BIOS Channel Map (0 to 15) 



A 




Channel 


0 


device 


= 


0 


Q 




Channel 


0 


subdevice 


= 


0 


B 


- 


Channel 


1 


device 


= 


0 


R 




Channel 


1 


subdevice 


= 


0 


C 




Channel 


2 


device 




0 


S 




Channel 


2 


subdevice 




0 


D 




Channel 


3 


device 




0 


T 




Channel 


3 


subdevice 




0 


E 




Channel 


4 


device 




0 


U 




Channel 


4 


subdevice 




0 


F 




Channel 


5 


device 




0 


V 




Channel 


5 


subdevice 




0 


G 




Channel 


6 


device 




0 


W 




Channel 


6 


subdevice 




0 


H 




Channel 


7 


device 




0 


X 




Channel 


7 


subdevice 




0 


I 




Channel 


8 


device 




0 


Y 




Channel 


8 


subdevice 




0 


J 




Channel 


9 


device 


m 


9 


Z 




Channel 


9 


subdevice 




5 


K 




Channel 


10 


device 




0 


0 




Channel 


10 


subdevice 


m 


0 


L 




Channel 


11 


device 




0 


1 




Channel 


11 


subdevice 




0 


M 




Channel 


12 


device 




0 


2 




Channel 


12 


subdevice 




0 


N 




Channel 


13 


device 




0 


3 




Channel 


13 


subdevice 




0 


0 




Channel 


14 


device 


m 


0 


4 




Channel 


14 


subdevice 




0 


P 




Channel 


15 


device 


m 


0 


5 




Channel 


15 


subdevice 


m 


0 



Select Menu item <CR exits>: 



If your partition for C: is not subdevice 5 change the number to the 
correct partition by typing 'Z' which the system will respond: 

Channel 9 subdevice =: 

Now enter the correct partition number. After you have entered the 
correct partition number, exit to the Low Level Configuration menu and 
type 'B' to enter the BIOS Channel Map (16 to 31): 
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BIOS Channel Map (16 to 31) 



A 


— 


Channel 


16 


device 


= 


0 


Q 


— 


Channel 


16 


subdevice 


- 


0 


B 


— 


Channel 


17 


device 


— 


9 


R 


— 


Channel 


17 


subdevice 




G 


C 


- 


Channel 


18 


device 


= 


9 


S 


— 


Channel 


18 


subdevice 


= 


7 


D 


- 


Channel 


19 


device 


= 


0 


T 


— 


Channel 


19 


subdevice 


= 


0 


E 


- 


Channel 


20 


device 


= 


0 


U 


- 


Channel 


20 


subdevice 


= 


0 


F 




Channel 


21 


device 




0 


V 




Channe 1 


21 


subdevice 




0 


G 




Channel 


22 


device 




0 


W 




Channel 


22 


subdevice 




0 


H 




Channel 


23 


device 




0 


X 




Channel 


23 


subdevice 




0 


I 




Channel 


24 


device 




0 


Y 




Channel 


24 


subdevice 




0 


J 




Channel 


25 


device 




0 


Z 




Channel 


25 


subdevice 




0 


K 




Channel 


26 


device 




0 


0 




Channel 


26 


subdevice 




0 


L 




Channel 


27 


device 




0 


1 




Channel 


27 


subdevice 




0 


M 




Channel 


28 


device 




0 


2 




Channel 


28 


subdevice 




0 


N 




Channel 


29 


device 




0 


3 




Channel 


29 


subdevice 




0 


0 




Channel 


30 


device 




0 


A 




Channel 


30 


subdevice 




0 


P 




Channel 


31 


device 




0 


5 




Channel 


31 


subdevice 




0 



Select Menu item <CR exits>: 

If your partition for D: is not subdevice 6 or your partition F: is not 
subdevice 7, then change the numbers to the correct partition by first 
typing 'R' which the system will respond: 

Channel 17 subdevice =: 
Now enter the correct partition number. After you have entered the 
correct partition number type 'S', the system will display: 

Channel 18 subdevice =: 
Enter the correct partition number and exit to the Low Level 
Configuration menu. 

Low Level Configuration 

A - BIOS Channel Map (0 to 15) 

B - BIOS Channel Map (16 to 31) 

C - Left Floppy Details 

D - Right Floppy Details 

E - Shared Floppy Details 

F - Winchester #1 

G - Winchester #2 

H - Winchester #3 

I - Winchester #4 

J - Operating System Information 

Select Menu item <CR exits>: 
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SAGE IV CP/M-68K INSTALLATION (cont.) 

The number of heads set for the Winchester on the distribution diskette is 
6. If you do not have a 18M disk then type 'F' and the system will respond: 



A 




Number of Cylinders 


306 


B 


— 


Bytes per Secotr 


512 


C 




Step Time 


192 


D 


_ 


Slew Time 


20 


E 


— 


Step Counter 


16 


F 


— 


Head Settle Time 


1216 


G 




Cylinder for Precomp 


306 


H 




Special types 


0 


I 




Test flags 


0 


J 




Track for shipping 


329 


K 




Low Read Counter 


1100 


L 




High Read Counter 


1140 


M 




Header Count 


400 


N 




Number of Heads 


6 


0 




Number of Retries 


11 


P 




Sectors per Track 


19 


Q 




Select Bit 


1 



Select Menu item <CR exits>: 



Type 'N' to change the number of heads, this should match the number in 
the p-system S AGE4UTIL . After you change the number of heads, exit to 
the to the Low Level Configuration menu. 

Low Level Configuration 

A - BIOS Channel Map (0 to 15) 

B - BIOS Channel Map (16 to 31) 

C - Left Floppy Details 

D - Right Floppy Details 

E - Shared Floppy Details 

F - Winchester #1 

G - Winchester #2 

H - Winchester #3 

I - Winchester #4 

J - Operating System Information 

Select Menu item <CR exits>: 
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Type 'J' to change the Operating System Information. If the channel 
table hasn't been changed from the original distribution diskette the 
system will respond: 

CPM system configuration 



A - Number of Disk Buffers 



B - Disk Buffer Size 



C 
D 
E 
F 
G 
H 
I 
J 
K 
L 
M 
N 
0 
P 

Q 
R 



Disk 
Disk 
Disk 
Disk 
Disk 
Disk 
Disk 
Disk 
Disk 
Disk 
Disk 
Disk 
Disk 
Disk 
Disk 
Disk 



Drive A 
Drive B 
Drive 
Drive 
Drive 
Drive 
Drive 
Drive 
Drive 
Drive 
Drive 
Drive 
Drive M 
Drive N 
Drive 0 
Drive P 



Offset: 2 
Offset: 2 
Offset: 1 
Offset: 1 
Offset: 2 
Offset: 1 
Drive not 
Drive not 
Drive not 
Drive not 
Drive not 
Drive not 
Drive not 
Drive not 
Drive not 
Drive not 



, Entries: 64 
, Entries: 64 
, Entries: 256 
, Entries: 256 
, Entries: 64 
, Entries: 256 
configured in 
configured in 
configured in 
configured in 
configured in 
configured in 
configured In 
configured in 
configured in 
configured in 



, Block size: 
, Block size: 
, Block size: 
, Block size: 
, Block size: 
, Block size: 
channel table 
channel table 
channel table 
channel table 
channel table 
channel table 
channel table 
channel table 
channel table 
channel table 



2048, 

2048 

4096. 

4096 

2048 ; 

4096 



4096 
Removable 
Removable 
Fixed 
Fixed 
Removable 
Fixed 



S - Physical Channel configuration T - Auto Start Command: *** None Defined 



Select Menu item <CR exits>: 



The only drives you can configure are the ones that have been entered in 
the channel table. The entries will say Not Configured instead of Drive 
not configured in channel table. Now type the letter to the Disk Drive 
you wish to configure. If you type 'I' for Disk Drive G: the system 
will display: 

A - Logical block size: 1024 C - Number of directory entries: 0 

B - Directory track offset: 0 D - Disk media: Fixed 

Select Menu item <CR exits>: 

Type 'A' and change the logical block size to 4096. Then type 'B' and 
change the directory track offset to 1. Type 'C and enter the number 
of directory entries you wish; usually for a Winchester partition the 
number is 256. Now verify 'D' to make sure the Disk media is fixed. 
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After all the above steps are done do carriage returns until the system 
displays: 

Ready to write changes to A: SAGEBIOS .SYS? 
Type *Y' . The screen will display: 
BIOS data saved. 

Exit SAGE4UTL and reset the machine. Boot from floppy again in order to 
load the new BIOS. Now enter SAGE4UTL, when it comes up type 'D' for 
Bootstrap copy. The system will respond: 

Source file or device <just CR quits>? 
Enter A:BOOT.68K. The system will then display: 

Ready to load bootstrap from volumn c:? 
Type 'Y' and the system will respond: 

Destination file or device <just CR quits>? 

Now type the device you want the boot stored on, the system will 
respond: 

Ready to store bootstrap on volumn x:? 

Type 'Y' . The system will respond either: 

Bootstrap written successfully, 
or 

Error writing x: 

If you get the Error writing x: make sure you have configured the 
partition with WFORMAT in the p-system and also have it configured in 
SAGE4UTL. 

When you have successfully written bootstraps to the partitions you have 
selected, exit SAGE4UTL and type the following: 

A>PIP x:=a:*.sys 

This will copy the system files to your Winchester partition x: , x: is 
your partition, i.e. c: , d: , etc. When the system files have been 
copied over to your new partition reset the machine and boot to the new 
partition using IH #x or IH name. 
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III Sage II Utility Routine 

The SAGEUTIL program (SAGEUTIL.C) sets up parameters for the hardware 
and software of the CP/M system. It is a powerful menu driven utility 
routine. SAGEUTIL formats disks, configures the BIOS, and copies the 
bootstrap loader. 

SAGEUTIL should be used only with a SAGE II using the release BIOS for 
The SAGE II. Do Not use SAGEUTIL on a SAGE IV. 

The CP/M-68K version of SAGEUTIL has almost identical instructions to 
the p-System version which is documented in Volume 1 of the Sage Owner's 
manual. However, there are a few differences so users familiar with the 
p-System version should not assume Identical operation. One of the 
obvious differences is that: 

All entries must be terminated with a carriage return. 

SAGEUTIL is started by typing "SAGEUTIL" from the CP/M-68K prompt: 
A> 

The system now displays: 

SAGE Computer System Utility Package - Version X.X 
C(onfigure, B(oot, F(ormat, Q(uit? 
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BIOS CONFIGURATION MANAGER 

1 1 1. 01 BIOS CONFIGURATION MANAGER 

Typing a 'C at the outer level prompt line will cause the utility to 
enter the BIOS Configuration Manager and ask: 



0(n-line, or F(ile change to BIOS? 

The 0(n-line option will only change the copy of the parameters which is 
operating in memory. This option is used for temporary changes that 
only affect the current computing session. Note that the Memory and 
System options (see following descriptions) are not allowed to be 
changed on-line. 

The F(ile option will ask: 

BIOS file name? 



The user should specify the device and file name of the BIOS file to be 
modified (or examined), typically B:SAGEBIOS.SYS. The device driver 
configuration parameters are located in the BIOS file. This data is 
read in for examination and/or modification by the configuration 
manager. The utility will report: 

The main prompt line for the Configuration Manager is: 

T(erminal, R(emote, F(loppys, M(emory-disk, P(rinter, S(ystem, Q(uit ? 



Choose the device to be changed: the terminal, the remote serial 
channel, the floppy drives, the RAM Disk storage device, the printer, or 
the System parameters and type the first letter of the option, then a 
<cr>. 
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BIOS CONFIGURATION MANAGER (cont.) 

At the end of the session (type Q(uit or <CR> at main prompt). If 
changes have been made to the configuration information the utility 
asks: 

Ready to write changes to your file ? 
or 

Ready to write changes to memory? 



The user then should type 'Y' resulting in the message: 
BIOS changes saved, Type space to continue. 



Changes made to memory involving the terminal configuration are 
questioned by the utility before installing. This is because the 
changes are applied immediately and may garble the following terminal 
output until the corresponding changes are made in the terminal. 

Changes made on-line to disk parameters will not take affect until a 
CNTRL-C is typed from the command line. 

Changes made to a file will not take affect until the system is re- 
booted using the modified BIOS. 
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III. 02 TERMINAL CONFIGURATION 



Typing 'T' to the Configuration Manager prompt displays a prompt line 
for information to configure the terminal serial channel: 



B(aud-rate, P(arity, S(top-bits, D(ata-bits , 0(ptions , Q(uit 



Selecting B(aud-rate displays: 

Currently using xxxxx baud rate 



A( 
B( 
C( 
D( 
E( 
F( 
G( 



19200 baud 
9600 baud 
4800 baud 
2400 baud 
2000 baud 
1800 baud 
1200 baud 



H( 
K 
J( 
K( 
L( 
M( 
N( 



600 baud 
300 baud 
200 baud 
150 baud 
110 baud 
75 baud 
50 baud 



X(use DIP switch specified baud rate 



Select baud rate from above: 



The DIP switch refers to PORT A switches on the back of the computer. 
Appendix A in Volume 1 describes the switch settings. 



Selecting P(arity displays: 
Currently parity is xxxx 



D(isable parity 
E(ven parity 
0(dd parity 
Q(uit 



Select parity option: 

Selecting S(top-bits displays: 

Currently x stop bit(s) assigned 

A( 1 stop bit 
B( 1.5 stop bits 
C( 2 stop bits 
Q(uit 



Select stop bit option: 
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Selecting D(ata-bits displays: 

Currently using x data bits 

A( 5 data bits 

B( 6 data bits 

C( 7 data bits 

D( 8 data bits 

Q(uit 

Select data size option: 
Selecting O(ptions displays: 
Terminal Options 

B(REAK KEY is ignored or B(REAK KEY enters PROM Debugger 

The actual BREAK KEY on normal terminals generates a continuous signal 
which causes the receiving USART to detect framing errors. The normal 
option for the BIOS is to ignore framing errors. If a large number of 
continuous framing errors (>255) is detected the USART receive channel 
is turned off and checked only at one second intervals. This allows the 
terminal to be turned off (often causing continuous framing errors) 
without turning off the SAGE II computer. The computer can continue to 
execute a program without being continuously interrupted by the powered 
down terminal. 

The optional mode for the BREAK key (or framing errors) is to enter the 
PROM Debugger. This mode should only be selected when troubleshooting 
programs at a low level. All normal program information is preserved 
and the program may be resumed by typing 'GO' to the Debugger. The 
Break key mode may be toggled by selecting the 'B' option. 
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III. 03 REMOTE CHANNEL CONFIGURATION 

Typing 'R' to the Configuration Manager prompt displays: 

B(aud-rate, P(arity, S( top-bits, D(ata-bits, 0(ptions, Q(uit? 



The baud rate, parity, stop bit, and data bit selections are the same as 
described for the Terminal Channel. The 0(ptions selection displays: 



I - XON/XOFF for Input is Disabled 

0 - XON/XOFF for Output is Disabled 

D - Data Set Ready is checked before transmitting 

P - Polling interval (in 1/64000' s second) 16000 

Select option to change <CR for none> 



The XON/XOFF protocol is a method used to keep the receiving system from 
losing data if the incoming data cannot be processed fast enough and the 
input buffer fills up. A typical case would be where data is being 
transferred over the remote serial link to be stored on a diskette. The 
buffer could fill up and overflow while the program is writing the 
previously received data to diskette. 

Using XON/XOFF protocol, the receiving system will send an XOFF 
character (13H) when the receive buffer is nearly full (240 out of 255 
characters). This leaves some room for the transmitting end to respond 
to the XOFF by stopping transmission. The receiving program will then 
process characters in the input buffer. When the amount of room 
available is 1/2 of the buffer (128 characters) the XON character (11H) 
is sent to turn the transmitting driver back on. This protocol can only 
be used where the XON and XOFF characters are unique and are never 
contained in the data. Thus this method will not work for transmitting 
binary images of files. 

The XON/XOFF protocol may be configured for either direction of 
transmission or both directions of transmission. When set up in the 
Input mode, the receiver will transmit XON and XOFF characters to 
control the transmitting from the opposite system. When set up in the 
Output mode, the receiver will respond to XON and XOFF characters which 
are received to start and stop the transmit direction. 
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The 'I' and 'O' selections will toggle the Input and Output XON/XOFF 
selections between Enabled and Disabled. 

The 'D' selection is provided to control a transmit check on Data Set 
Ready. When low level signal handshaking is needed on the Remote Serial 
channel, the Data Set Ready input should be used instead of the Clear to 
Send input (see writeup on Hardware- Printer Port). When a character is 
transmitted the DSR bit is checked. If DSR is not active, a delay is 
scheduled (value controlled by 'P' selection) before the next test. The 
'D' selection will toggle the enabling or disabling of the DSR check. 
When the check is enabled, the 'P' selection will ask: 

Polling interval? 

This is the delay in 1/64000' s second between polling attempts of the 
Data Set Ready signal. 
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III. 04 FLOPPY PARAMETER MAINTENANCE 

Typing 'F' to the Configuration Manager prompt requests: 



Select drive number (A or B or just CR quits) ? 
When the drive is selected the utility will reply: 



Current drive A setup: 

SAGE double side, 80 track (1280 blocks) 

A - SAGE double side, 80 track (1280 blocks) 

B - SAGE double side, 40 track ( 640 blocks) 

C - IBM single side, 40 track (320 blocks) 

D - IBM double side, 40 track (640 blocks) 

E - Network Consulting single side, 40 track ( 400 blocks) 

F - Network Consulting double side, 40 track ( 800 blocks) 

G - Network Consulting double side, 80 track (1600 blocks) 

H - Softech Universal Medium, single side, 35 track (280 blocks) 

I - No drive equipped 

Z - Non standard type 

Select floppy option (or CR to quit): 



The appropriate letter may be typed to select the option desired. The 
80 track (96 TPI) diskettes may only be accessed on systems with 80 
track drives. The 40 track (48 TPI) diskettes may be read on an 80 
track drive but cannot be written. Note that only SAGE 80 track or 40 
track diskettes may be used to start (bootstrap) the system. The PROM 
driver used for bootstrapping does not handle all the varied formats 
which are configurable by the BIOS. 

IBM initially provided only single sided drives on their personal 
computer. Therefore when they came out with double sided drives, they 
deviated from the optimum cylinder orientation so that the the same 
scheme would read both the single sided and double sided drives. With 
the IBM track format, data is stored in ascending track order on side 
zero and then back in descending track order on side one. The normal 
SAGE II method is to store data on side zero and then side one of each 
track before stepping the head to the next cylinder. 
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A special sector numbering scheme was developed by Network Consulting 
Incorporated for their BIOS on the IBM Personal Computer. It allows 
their software to automatically distinguish between their 10 sector per 
track diskettes and the normal 8 sector per track IBM standard 
diskettes. The SAGE II provides a compatibility mode to this format but 
does not attempt to automatically distinguish which format is being 
used. Note: Attempting to record ten 512 byte sectors of data on a 
track will generally work but does stretch the drive specifications. 
This format may not be reliable on all systems. 

The 'Universal Medium' (TM) is a concept proposed by Softech 
Microsystems for distribution of UCSD p-System application software. 
This format is thought to be readable by the highest number of p-System 
implementations. The format may be written by 40 track (48 TPI) drives 
only but may be read on any SAGE system. 

The 'Z' selection for Non standard type will bring up an alternate menu 
which allows changing low level parameters of the floppy disk driver. 
Note that most selections require knowledge of floppy disk recording 
protocols and possibly controller information. The alternate menu is 
shown below: 



Current drive A setup: 

A - number of Sides: 2 

B - cylinders: 80 

C - sectors per Track: 8 

D - IBM track format: No 

E - Density: Dbl 

F - Retries 3 

G - Ignore errors: No 

H - Read 48 on 96 TPI: No 

I - NCI 10 sects/trk: No 

J - Read after write: No 

Select item to change (or CR 



K - 


bytes per sector: 


512 


L - 


Gap 3 parameter: 


42 


M - 


Data length: 


255 


N - 


Step rate: 


4 


0 - 


Gap 3 for format: 


80 


P - 


Pattern for format: 


229 


R - 


Skew for format: 


0 


Z - 


standard options 





to quit) : 



Note that selections "F" and "J" are of great value in trying 
to recover data from bad diskettes. By increasing the number 
of times the computer tries to read the disk (F) some lost 
files might be recovered. The read after write option (J) 
checks the data just after it is written so that you will 
know immediately that you data was not properly saved. 
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Selecting 'A' will ask for 0, 1 or 2 sides for the diskette. Zero 
should be specified if the drive is not equipped. This will return an 
early error without having to go through a timeout process. 

Selecting 'B' asks for the number of cylinders on the diskette. 
Cylinders and tracks are often used in the same context. A cylinder 
represents a head position which may access a track on each side of a 
double sided diskette. 

Selecting 'C asks for the number of sectors per track. Typical values 
are 8 for 512 byte sectors or 16 for 256 byte sectors. Note that the 
Gap 3 parameter and the Gap 3 for formatting also must be modified for a 
specific Sectors per Track and Bytes per Sector combination. Also the 
density selection interacts with all these parameters. 

Selecting 'D' toggles the IBM track format compatibility on or off. For 
double sided diskettes, data is stored in ascending track order on side 
zero and then back in descending track order on side one. The normal 
SAGE II method is to store data on side zero and then side one of each 
track before stepping the head to the next cylinder. 

Selecting 'E' asks 'S(ingle or D(ouble density. The drives provided on 
the SAGE II will normally be used in the double density mode. The 
single density option should only be required to access data from 
another system which provides only single density drives. The Sectors 
per Track, Bytes per Sector, and Gap 3 values must all be coordinated 
with the density selection. 

Selecting 'F' asks for the number of retries. This question should be 
answered with the number of retries that the diskette driver should make 
before returning an error. The system is normally shipped with 3 
retries specified but this may be increased to attempt to access data on 
a marginal diskette. A carriage return is necessary as a multiple digit 
number may be typed. 

Selecting 'G' will toggle on or off the ignoring of errors from the 
floppy controller. The controller errors should never be ignored in 
normal operation. This option is only provided to allow a head 
alignment procedure to be performed using a special alignment diskette 
which contains unreadable data. The driver must continue to read the 
diskette so that signals may be observed with test equipment, even 
though the controller is detecting errors. 

Selecting 'H' will toggle on or off a feature which allows reading of 48 
TPI diskettes on a 96 TPI drive. Note that writing to a 48 TPI diskette 
is not allowed because the 48 TPI drives cannot read the data. The 96 
TPI drive is stepped two physical tracks for every track normally 
requested by the driver. 
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Selecting 'I' will toggle on or off an option to use a special sector 
numbering scheme developed by Network Consulting Incorporated. This 
scheme was implemented by NCI for their BIOS on the IBM Personal 
Computer. It allows their software to automatically distinguish between 
their 10 sector per track diskettes and the normal 8 sector per track 
IBM standard diskettes. Sectors are numbered from 9 to 18 (except the 
first sector on the device which is numbered 1). 

Selecting 'J' will toggle on or off an option to perform a read of 
information from sectors which have just been written. This Read after 
Write feature verifies that the controller can read back the information 
without detectable errors. This option slows down the writing process 
but should be left enabled as it provides a valuable "front-line" 
defense against bad media. 

Selecting 'K' will ask for the number of bytes per sector. Typically 
this is 512 for 8 sectors per track or 256 for 16 sectors per track. 
Note that the Gap 3 parameter and the Gap 3 for formatting also must be 
modified for a specific Bytes per Sector, Sectors per Track and density 
combination. Note also that selections of Bytes per Sector above 512 
are not currently supported. 

Selecting 'L' will ask for the Gap 3 parameter (in decimal). This 
parameter is required by the controller for Read and Write commands to 
avoid the splice point between the data field and the ID field of 
contiguous sectors. The value depends on the combination of Bytes per 
Sectors, Sectors per Track, and density selection. Suggested values 
from the controller documentation are: 



Density 


BPS 


SPT 


Gap 3 


Gap 


Single 


128 


18 


7 


9 




128 


16 


16 


25 




256 


8 


24 


48 




512 


4 


70 


135 


Double 


256 


18 


10 


12 




256 


16 


32 


50 




512 


8 


42 


80 



Selecting 'M' will ask for Data Length. This parameter is only used by 
the controller when the sector size is less than 256 bytes per sector. 
In these cases the Data Length is the number of bytes per sector 
(typically 128). For all other cases the Data Length is normally set to 
255. 

Selecting 'N' will ask for Step Rate. This is the number of 
milliseconds allowed between head step pulses by the controller. The 
value may be varied between 2 to 32 milliseconds (only even number 
values are supported). 
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Selecting '0' will ask Gap 3 for formatting. Values for this parameter 
are used when formatting a diskette and are contained in the Gap 3 table 
under selection 'L'. 

Selecting 'P' will ask for a Pattern for formatting. This value (0 to 
255) is written into each data byte during the formatting of a diskette. 
The normal default value is 229 (E5 hex) . 

Selecting 'R' will ask for a Skew factor. This value is normally zero. 
The 10 sector per track formats generally specify a two sector skew to 
be formatted onto the diskette. This improves the performance when 
accessing the diskette over track boundaries. The IBM format is 
normally identical to the standard SAGE 8 sector per track format as the 
difference is only in where the data is written. On 10 sector per track 
diskettes with IBM format, the skew is reversed for head one because the 
tracks are accessed in decreasing order. The special NCI format also 
requires use of the IBM format selection. 

Selecting 'Z' will toggle the menu back to the standard options. 
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III. 05 MEMORY DISK 

This option determines the size of RAM Disk and the size of the TPA 
(Transient Program Area). See the CP/M memory map for the locations of 
these areas. 

Type 'M' <cr> to the Configuration Manager for these options. 
If RAM Disk is enabled the screen will show: 
RAM Disk Configuration 

TPA is xxxK (RAM Disk fills remaining available memory) 
E(nable / D(isable RAM Disk, Q(uit 
If RAM Disk is DISABLED the screen will show: 
RAM Disk Configuration 

RAM Disk is disabled (TPA fills available memory) 
E(nable / D(isable RAM Disk, Q(uit 
Select one of these options: 

E - asks " Enter TPA size in kilobytes? " 

Type in the size of the TPA: EXAMPLE: 128 
The size is in units of 1024 bytes (K bytes) 

D - Disables RAM Disk. 

Q - Exits RAM Disk configuration manager. 
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III. 06 PRINTER CONFIGURATION 

Typing 'P' to the Configuration Manager prompt displays the current 
printer configuration along with the menu: 

Modes: 

A( Printer on Remote Channel 

(set up using Remote serial channel parameters) 
B( printer on parallel port with interrupts 
C( printer on parallel port with scheduled polling 
D( printer is disabled 

L( inefeed after carriage return is printed 

The 'A' option is used when the printer is to be driven from the 
auxiliary (Remote) serial channel. When used with this option the 
X0N/X0FF protocol for Output or Data Set Ready protocol may be specified 
(under the Remote Configuration section) for printers which will provide 
this data to control system transmission. 

The 'B' option is used for printers which conform to the standard 
Centronics parallel port protocol with an Acknowledge signal which 
produces an interrupt to say that the character has been received. 

The 'C option is used for printers which use the Centronics parallel 
port definition but rely on the system polling the Busy signal from the 
printer to determine when the next transmission is possible. Using this 
option, after a character is output the routine will poll the Busy line 
for a selected number of times. If the printer has an internal buffer 
it may be able to receive the next character within a reasonably short 
time. If the printer is still busy after the specified number of 
polling cycles, a configurable delay is scheduled which releases the 
processor for other work. After each delay interval the processor 
returns to check if the printer is busy. In this manner a normally 
polled printer will not completely tie up the processor. The 'C option 
displays: 

Printing on parallel port with scheduled polling 
P(olling attempts before scheduled delay xxx 
D(elay in 1/64000' s second before repolling xxx 

Select P(olling, D(elay, Q(uit: 

The 'L' option will toggle on on or off an option to inhibit the 
automatic printing of a Linefeed after each Carriage Return. Some 
printers cannot disable their internal Linefeed generation after a 
Carriage return. The p-System operating system does not have a standard 
method (via SETUP) of inhibiting automatic Linefeed generation during 
general output to the PRINTER: device. 
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III. 07 SYSTEM PARAMETER CONFIGURATION 

Typing 'S' to the Configuration Manager prompt displays the current 
System Parameter configuration along with the menu. This is an example 
of a typical setup. 

. — i — ■ 1 

A(Drive Configuration: 

1( Logical block size: 2048 3( Number of directory entries: 64 

2( Directory track offset: 2 4( Disk media: removable 

B(Drive Configuration: 

1( Logical block size: 2048 3( Number of directory entries: 64 

2( Directory track offset: 2 4( Disk media: removable 

E(Drive Configuration: (RAM Disk) 

1( Logical block size: 2048 3( Number of directory entries: 64 

2( Directory track offset: 0 4( Disk media: fixed 

F(Disk I/O buffer size: 4096 
G(Number of disk I/O buffers: 3 
Q(uit 

Enter selection (A - Q)? 



A,B, or E ...Drive Configuration 

The system configuration defines these parameters for each floppy and 
RAM Disk: 

logical block size 
directory track offset 
directory size 

whether the floppy is fixed or removable. 

The RAM Disk is always considered fixed and has a track offset of zero. 

NOTE: You cannot alter the drive configuration on-line, but you can 
view them. "On-line" changes will have no effect as they will not be 
updated. 
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Once a drive (A,B, or E ) has been selected the screen will display: 
Enter subgroup (1 - 4, Q)? 



Typing 1-4 selects the corresponding subgroup as follows: 

1.. .Block size (1024,2048,4096,8102,16384)? 

This the logical block size used by CP/M-68K for disk allocation. 

2. . .Directory offset (0-7) tracks? 

This is the track where the directory starts (standard is 2). 

3... Number of directory entries? 

This is the number of entries in the directory. The number must be 
an even multiple of 32 (32,64,96...). Any other number will be 
decreased to the nearest multiple of 32. 

4 . . .Fixed or Removable 

This switches the disk type from fixed media to removable media and 
visa versa. 

Q...QUIT 

Skips request. 
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F(Disk I/O buffer size: 

Typing F from the SYSTEM CONFIGURATION menu will allow you to change the 
buffer size. The screen displays: 

F - Enter buffer size in bytes 

Enter the buffer size in bytes (the buffer size should be a track size) 
It will be rounded off to within 512 bytes. The maximum length is 16384 
bytes and the minimum length is 512. 

G(Number of disk I/O buffers: 

Typing G from the menu will allow you to change the number of I/O 
buffers. The screen displays: 

G - Enter number of I/O buffers (1 - 16)? 

Enter the number of I/O buffers wanted. A maximum of 16 are allowed. 

Q(uit Typing Q leaves system configuration. The changes will not be 
saved until prompted. 

NOTE: CP/M does not use the clock features of the SAGE, so there is no 
ADJUST option here as there is in the p-System SAGEUTIL. 
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III. 08 BOOTSTRAP COPY UTILITY 

The Bootstrap Copy Utility is selected from the outer level Utility 
prompt line with the character 'B' . It is specifically for the SAGE II 
computer system. The routine will copy the bootstrap from blocks 0 & 1 
of a device to another device or from a file to a device. The routine 
insures that the data is a SAGE bootstrap by checking the first four 
characters of the information for the characters 'BOOT'. 

The Bootstrap Copy Utility will ask: 

Source file or device <just CR quits> ? 

Once a file or device number( examples A, A:) is specified 
the utility asks: 

Ready to load bootstrap from file xxxxxxxx 
or volume x 

If the reply is 'V the utility will ask: 

Destination file or device <just CR quits> ? 

Note that a transfer of a bootstrap to a file is currently 
not supported. 

( 

Once the destination device number is specified the utility asks: 

Ready to copy bootstrap to volume x? 
If the reply is 'V <cr> the utility will perform the transfer. 
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III. 09 FLOPPY DISK FORMATTER 

The Floppy Diskette Formatter is selected from the outer level Utility 
prompt line with the character 'F'. This function is necessary to 
initialize diskettes with address information so that the hardware 
floppy controller can determine where to read and write the user's data. 
Caution: Formatting a diskette will destroy any previous data recorded 
on the diskette. The Formatter Utility will ask: 

Drive to be formatted (A or B) ? 

Once answered the utility will reply with the current configuration set 
up in the BIOS for that drive. The formatter will only format diskettes 
according to the current floppy configuration. If formatting for a 
different configuration is desired, the SAGEUTIL C(onf iguration option 
must be used to alter the floppy assignment. The format routine will 
ask: 

Is diskette ready for formatting in drive x? 

The user should make sure that the wrong drive (typically containing the 
system diskette) has not been selected, and that the diskette to be 
formatted has been placed in the drive before answering 'Y* <cr>. The 
utility will reply with 'Format Started' and print a dot for each track 
as it is formatted. The 48 TPI diskettes will print two lines of 40 
dots (each cylinder has two tracks, one on each side of the diskette). 
The 96 TPI diskettes will print four lines of 40 dots. After the 
formatting information has been written the utility displays 
'Verification' and reads back all the tracks, again printing a dot for 
each track processed. 

After successfully formatting a diskette the utility will display: 

Format Complete 

More diskettes to format? 

If the user answers 'Y' the utility resumes by asking again if the 
diskette is reading for formatting. 

If an error occurs (any error including soft errors), the formatter will 
inform you. The format process must complete without any errors in 
order to insure good data areas. If you consistantly have problems 
formatting disks, try changing to a better brand, or cleaning the disk 
heads. 
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IV Sage IV Utility Routine 



The SAGE4UTL program (SAGE4UTL.C) sets up parameters for the hardware 
and software of the CP/M system. It is a powerful menu driven utility 
routine. SAGE4UTL formats floppy disks, configures the BIOS, and copies 
the bootstrap loader. 

SAGE4UTL can be used on a SAGEII and boot if you use the SAGEIV BIOS on 
the SAGEII. 

The CP/M-68K version of SAGE4UTL has almost identical instructions to 
the p-System version which is documented in Sage IV - Users' Manual 
Supplement. However, there are a few differences so users familiar with 
the p-System version should not assume identical operation. One of the 
obvious differences is that: 

All entries must be terminated with a carriage return. 

SAGE4UTL is started by typing "SAGE4UTL" from the CP/M-68K prompt: 
A> 

The system now displays: 

SAGE COMPUTER SYSTEM UTILITY PACKAGE - VERSION X.X 

A - On-line Configuration 

B - BIOS file Configuration 

C - Floppy Formatter 

D - Bootstrap Copy 

E - Prepare Drives for Shipping 

Select Menu item <CR exits>: 
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A. . .On-line Configuration 

Changes made "on-line" are effective only until the next boot or system 
reset. This option should be used for temporary changes that only 
affect the current computing session. When typed, the option will call 
the configuration menu. After the configuration has been set up, the 
system will ask: 

"Make On-line Changes?" 

Type "Y" to accept the changes or "N" to forget the changes. 

Changes made to memory involving the terminal configuration are 
questioned by the utility before installing. This is because the 
changes are applied immediately and may garble the following terminal 
output until the correspond- ing changes are made in the terminal. 

Changes made on-line to disk parameters will not take affect until a 
CNTRL-C is typed from the command line. 

B. ..BIOS file Configuration 

To make permanent changes, use option "B" to change the BIOS file 
Configuration. This option will ask: 

Enter BIOS file? 

The user should specify the device and file name of the BIOS file to be 
modified (or examined), typically B: SAGEBIOS .SYS. The device driver 
configuration parameters are located in the BIOS file. This data is 
read in for examination and/or modification by the configuration 
manager. 

Then the configuration menu will display. At the end of the session 
(use carriage returns to exit the menus), SAGE4TUIL will ask: 

Ready to write changes to your file? 

Type "Y" or "N" . The screen will display: 

BIOS data saved 

BIOS changes made to a file will not take affect until the system is 
re-booted using the modified BIOS. 
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C... Floppy Formatter 

The format function works the same as explained in the section 
formatting a diskette. 



D •« .Bootstrap Copy 

Option 'D' operates identical to the explanation in the section 
on copying a boot. 

E.. .Prepare Drives for Shipping 

Option 'E' is explained in detail in the SAGE IV- USERS' MANUAL 
SUPPLEMENT in the section called E... Prepare Drives for Shipping. 



The configuration control manager is called from either the On-line 
option or the BIOS file change option. The menu offers several 
selections: 



On-line Configuration Control 



A 


- Terminal 




B - 


Remote 


C 


- Left Floppy 




D - 


Right Floppy 


E 


- RAM Disk 




F - 


Printer 


G 


- Extra Serial Port 


#1 


H - 


Extra Serial Port #2 


I 


- Extra Serial Port 


#3 


J - 


Extra Serial Port #4 


K 


- Parallel port 




L - 


Low Level Configuration 



Select Menu item <CR exits>: 
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IV. 01 A - Terminal configuration 

The various options for the Terminal configuration are: 

Terminal Configuration Control 

A - Baud Rate DIP Switch B - Parity DIP Switch 

C - Stop Bits 1 Stop Bit D - Data Bits 8 Data Bits 

E - Xon/Xoff on input On I - BREAK to debugger Off 



Select item to change <CR exits>: 

The DIP switch references the GROUP A switches on the back of the 
computer. Refer to APPENDIX A of Vol.1 of the SAGE Users' Manual. 
Each of the options will present a menu of selections. A star ( * 
) after an option indicates the current selection. 

IV. 01. 01 Baud Rate 

Baud Rate Selection 



A - 


19200 baud 


H - 


600 


baud 


B - 


9600 


baud 


I - 


300 


baud 


C - 


4800 


baud 


J - 


200 


baud 


D - 


2400 


baud 


K - 


150 


baud 


E - 


2000 


baud 


L - 


110 


baud 


F - 


1800 


baud 


M - 


75 


baud 


G - 


1200 


baud 


N - 


50 


baud 








X - 


DIP 


Switch 



Select baudrate option? 
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IV. 01. 02 Parity 

Parity Selection 

A - Even parity 

B - Odd parity 

C - Disabled parity 

Select parity option? 



IV. 01. 03 Stop bit 

Stop Bit Selection 

A - 1 Stop Bit * 
B - 1.5 Stop Bits 
C - 2 Stop Bits 

Select Stop Bit option? 



IV. 01. 04 Data bits 

Data Bit Selection 

A - 5 Data Bits 

B - 6 Data Bits ' 

C - 7 Data Bits 

D - 8 Data Bits * 

Select Data size option? 



The 'E' option will set the XON/XOFF handling mode for the 
terminal. If the XON/XOFF mode is enabled, the terminal driver 
will respond to XON and XOFF characters generated by the terminal 
to slow down the data going to the terminal. When using this 
option, the p- System Start/Stop character must be set to XOFF 
(ASCII DC3, Ctrl S) using the program SETUP. Manual control of the 
terminal output will also require typing Ctrl S (XOFF) to stop the 
output and Ctrl Q (XON) to restart the output. 



The actual BREAK KEY on normal terminals generates a continuous 
signal which causes the receiving USART to detect framing errors. 
The normal option for the BIOS is to ignore framing errors. If a 
large number of continuous framing errors (>255) is detected the 
USART receive channel is turned off and checked only at one second 
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intervals. This allows the terminal to be turned off (often 
causing continuous framing errors) without turning off the SAGE IV 
computer. The computer can continue to execute a program without 
being continuously interrupted by the powered down terminal. 

The optional mode for the BREAK key (or framing errors) is to enter 
the PROM Debugger. This mode should only be selected when 
troubleshooting programs at a low level. All normal program 
information is preserved and the program may be resumed by typing 
'GO' to the Debugger. 

IV. 02 B - Remote channel 



The Remote Channel is configured much the same way as the Terminal. 



Remote Serial Channel Control 



A 
C 
E 
G 



Baud Rate 9600 baud B - Parity Even parity 

Stop Bits 1 Stop Bit D - Data bits 7 Data Bits 

Off F - Xon/Xoff for output Off 

On H - DSR Polling interval 16384 



- Xon/Xoff for input 



- DSR Polling 



Select item to change <CR exits>: 



The Baud Rate, Parity, Stop bit and Data bit menus for the Remote 
channel are nearly identical to that of the terminal except that 
there are no DIP switch selections for the Remote Channel. 



IV. 02. 01 XON-XOFF 



The XON/XOFF protocol is a method used to keep the receiving system 
from losing data if the incoming data cannot be processed fast 
enough and the input buffer fills up. A typical case would be 
where data is being transferred over the remote serial link to be 
stored on a diskette. The buffer could fill up and overflow while 
the program is writing the previously received data to diskette. 

Using XON/XOFF protocol, the receiving system will send an X0FF 
character (13H) when the receive buffer is nearly full (240 out of 
255 characters). This leaves some room for the transmitting end to 
respond to the X0FF by stopping transmission. The receiving 
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program will then process characters in the input buffer. When the 
amount of room available is 1/2 of the buffer (128 characters) the 
XON character (11H) is sent to turn the transmitting driver back 
on. This protocol can only be used where the XON and XOFF 
characters are unique and are never contained in the data. Thus 
this method will not work for transmitting binary images of files. 

The XON/XOFF protocol may be configured for either direction of 
transmission or both directions of transmission. When set up in 
the Input mode, the receiver will transmit XON and XOFF characters 
to control the transmitting from the opposite system. When set up 
in the Output mode, the receiver will respond to XON and XOFF 
characters which are received to start and stop the transmit 
direction. 

IV. 02. 02 DSR - DATA SET READY 

The 'G' selection is provided to control a transmit check on Data Set 
Ready. When low level signal handshaking is needed on the Remote 
Serial channel, the Data Set Ready input should be used instead of the 
Clear to Send input (see writeup on Hardware-Printer Port). When a 
character is transmitted the DSR bit is checked. If DSR is not 
active, a delay is scheduled (value controlled by 'H' selection) 
before the next test. 

The 'H' option specifies the delay in 1/64000' s second between polling 
attempts of the Data Set Ready signal. 
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IV. 03 C & D - Right & Left Floppy 

In order to read (and write) as many different formats as possible, 
the floppy configuration sections allows considerable flexibility 
in setting the format parameters. The first menu presents commonly 
used formats (A-H) which are pre-defined. 

The I option will refer you to the Low Level Configuration option 
in order to setup specific parameters. Option I is only for 
display and not for selection. If the low level parameters do not 
match a standard option then this line is displayed. 

Right (or Left) Floppy Drive Selection 

A - SAGE double side, 80 track (1280 blocks) * 

B - SAGE double side, 40 track ( 640 blocks) 

C - IBM single side, 40 track (320 blocks) 

D - IBM double side, 40 track (640 blocks) 

E - Network Consulting single side, 40 track (400 blocks) 

F - Network Consulting double side, 40 track (800 blocks) 

G - Network Consulting double side, 80 track (1600 blocks) 

H - Softech Universal Medium, single, 35 track (280 blocks) 

I - SAGE 10 sector per track, 80 tracks (1600 blocks) 

J - Non Standard type 

K - No drive equipped 



Select Menu item <CR exits, ! aborts>: 

The 80 track (96 TPI) diskettes may only be accessed on systems 
with 80 track drives. The 40 track (48 TPI) diskettes may be read 
on an 80 track drive but cannot be written. Note that only SAGE 80 
track or 40 track diskettes may be used to start (bootstrap) the 
system. The PROM driver used for bootstrapping does not handle all 
the varied formats which are configurable by the BIOS. 

IBM initially provided only single sided drives on their personal 
computer. Therefore when they came out with double sided drives, 
they deviated from the optimum cylinder orientation so that the the 
same scheme would read both the single sided and double sided 
drives. With the IBM track format, data is stored in ascending 
track order on side zero and then back in descending track order on 
side one. The normal SAGE IV method is to store data on side zero 
and then side one of each track before stepping the head to the 
next cylinder. 

A special sector numbering scheme was developed by Network 
Consulting Incorporated for their BIOS on the IBM Personal 
Computer. It allows their software to automatically distinguish 
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between their 10 sector per track diskettes and the normal 8 sector 
per track IBM standard diskettes. The SAGE IV provides a 
compatibility mode to this format but does not attempt to 
automatically distinguish which format is being used. Note: 
Attempting to record ten 512 byte sectors of data on a track will 
generally work but does stretch the drive specifications. This 
format may not be reliable on all systems. 

The 'Universal Medium' (TM) is a concept proposed by Softech 
Microsystems for distribution of UCSD p-System application 
software. This format is thought to be readable by the highest 
number of p-System implementations. The format may be written by 
40 track (48 TPI) drives only but may be read on any SAGE system. 

IV. 04 E - RAM Disk 

This option determines the size of RAM Disk and the size of the TPA 
(Transient Program Area). See the CP/M memory map for the 
locations of these areas. 

Type 'M' <cr> to the Configuration Manager for these options. 
If RAM Disk is enabled the screen will show: 
RAM Disk Configuration 

TPA is xxxK (Ram Disk fills remaining available memory 
If RAM Disk is DISABLED the screen will show: 
RAM Disk Configuration 

RAM Disk is disabled (TPA fills available memory) 
Select one of these options: 

A - asks "Enter TPA size in kilobytes?" 

Type in the size of the TPA: EXAMPLE: 128 
The size is in units of 1024 bytes (K bytes) 

B - Disables RAM Disk. 

A - Enable RAM Disk 
B - Disable RAM Disk 

Select option <CR exits> 
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IV. 05 F - Printer 

The 'F' option is used to set the printer to the proper channel. The 
channel must then be set to the proper configuration from its own menu. 

Printer Configuration Control 

A - Printer port assignment Parallel port 

B - Linefeed after carriage return On 

Select Menu item <CR exits>: 

The linefeed option may be turned off for printers which 
automatically insert a linefeed after a carriage return. 

Printer Port Assignment 

Remote serial channel 

Parallel port * 
Extra serial channel #1 
Extra serial channel #2 
Extra serial channel #3 
Extra serial channel #4 
Disabled 

Select Menu item <CR exits>: 



IV. 06 G-J - Extra Serial Ports #l-#4 

The extra serial ports are setup much like the terminal channel and the 
Remote channel. 

Extra Serial Channel #1 Control 

A - Baud Rate 19200 baud B - Parity Even parity 

C - Stop Bits 1 Stop Bit D - Data bits 8 Data Bits 

E - Xon/Xoff for input Off F - Xon/Xoff for output Off 



Select Menu item <CR exits, ! aborts>: 
Select item to change <CR exits>: 
Note: 200 baud is not a supported option for the extra serial channels. 



A - 

B - 

C - 

D - 

E - 

F - 

G - 
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IV. 07 K - Parallel Port 

This option controls how the parallel port is accessed, with interrupts 
on or in a polling loop. 

Parallel Port Control 

A - Interrupt (vs Scheduled Polling) On 
B - Polling attempts before delay 500 
C - Delay before re-polling 236 

Select Menu item <CR exits>: 

Scheduled Polling is used for printers which use the Centronics parallel 
port definition but rely on the system polling the Busy signal from the 
printer to determine when the next transmission is possible. 

Using this option, after a character is output the routine will poll the 
Busy line for a selected number of times. If the printer has an 
internal buffer it may be able to receive the next character within a 
reasonably short time. If the printer is still busy after the specified 
number of polling cycles, a configurable delay (option "C" ) is 
scheduled which releases the processor for other work. After each delay 
interval the processor returns to check if the printer is busy. In this 
manner a normally polled printer will not completely tie up the 
processor. 
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IV. 08 M - Low Level Configuration 

The Low Level Configuration manager defines parameters for the channel 
maps and disk formats. 

Low Level Configuration 

A - BIOS Channel Map ( 0 to 15) 

B - BIOS Channel Map (16 to 31) 

C - Left Floppy Details 

D - Right Floppy Details 

E - Shared Floppy Details 

F - Winchester #1 

G - Winchester #2 

H - Winchester #3 

I - Winchester #4 

J - Operating System Information 

Select Menu item <CR exits>: 



IV. 08. 01 Channel Map 

Refer to the section called "BIOS CHANNEL MAP" for a discussion on how 
channels and devices are mapped together in the SAGE. Basically, each 
physical device is assigned a logical channel. The "channels" transport 
information from the routines to the physical device. 

The following map shows the default set up by the factory. 



Sage Computer Technology 
43 



SAGE CP/M 

Sage IV Utility Routine 

M - Low Level Configuration (cont.) 



BIOS Channel Map (0 to 15) 



A 




Channel 


0 


device 




0 


Q 




Channel 


0 


subdevice 




0 


B 




Channel 


1 


device 


= 


1 


R 




Channel 


i 

1 


subdevice 


= 


0 


C 




Channel 


2 


device 




2 


S 




Channel 


2 


subdevice 




0 


D 




Channel 


3 


device 


= 


3 


T 




Channel 


3 


subdevice 




0 


E 




Channel 


4 


device 




* 

4 


U 




Channel 


4 


subdevice 


= 


0 


F 




Channel 


5 


device 




5 


V 




Channel 


5 


subdevice 




0 


G 




Channel 


6 


device 




6 


W 




Channel 


6 


subdevice 




0 


H 




Channel 


7 


device 




7 


X 




Channel 


7 


subdevice 




0 


I 




Channel 


8 


device 




8 


Y 




Channel 


8 


subdevice 




0 


J 




Channel 


9 


device 


= 


9 


Z 




Channel 


9 


subdevice 




5 


K 




Channel 


10 


device 




10 


0 




Channel 


10 


subdevice 




0 


L 




Channel 


11 


device 




11 


1 




Channel 


11 


subdevice 




0 


M 




Channel 


12 


device 


s 


12 


2 




Channel 


12 


subdevice 




0 


N 




Channel 


13 


device 




13 


3 




Channel 


13 


subdevice 




0 


0 




Channel 


14 


device 




14 


4 




Channel 


14 


subdevice 




0 


P 




Channel 


15 


device 


M 


15 


5 




Channel 


15 


subdevice 




0 



Select Menu item <CR exits> 

BIOS Channel Map (16 to 31) 



A 




Channel 


16 


device 




16 


Q 




Channel 


16 


subdevice 




0 


B 




Channel 


17 


device 


p 


9 


R 




Channel 


17 


subdevice 




6 


C 




Channel 


18 


device 




9 


S 




Channel 


18 


subdevice 




7 


D 




Channel 


19 


device 


= 


0 


T 




Channel 


19 


subdevice 




0 


E 




Channel 


20 


device 




0 


U 




Channel 


20 


subdevice 




0 


F 




Channel 


21 


device 




0 


V 




Channel 


21 


subdevice 




0 


G 




Channel 


22 


device 




0 


W 




Channel 


22 


subdevice 




0 


H 




Channel 


23 


device 




0 


X 




Channel 


23 


subdevice 


= 


0 


I 




Channel 


24 


device 




0 


Y 




Channel 


24 


subdevice 




0 


J 




Channel 


25 


device 


= 


0 


Z 




Channel 


25 


subdevice 




0 


K 




Channel 


26 


device 




0 


0 




Channel 


26 


subdevice 




0 


L 




Channel 


27 


device 




0 


1 




Channel 


27 


subdevice 




0 


M 




Channel 


28 


device 




0 


2 




Channel 


28 


subdevice 




0 


N 




Channel 


29 


device 


m 


0 


3 




Channel 


29 


subdevice 




0 


0 




Channel 


30 


device 




0 


4 




Channel 


30 


subdevice 




0 


P 




Channel 


31 


device 




0 


5 




Channel 


31 


subdevice 


= 


0 



Select Menu item <CR exits>: 
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IV. 08. 02 Right & Left Floppy configuration 

The 'D or E' selection for Right or Left floppy configuration will bring 
up an alternate menu which allows changing low level parameters of the 
floppy disk driver. Note that most selections require knowledge of 
floppy disk recording protocols and possibly controller information. 
The Low Level parameters of the Floppy configuration are rarely changed 
from the factory setup unless the user is attempting to read or write to 
a non-standard format. The alternate menu is shown below: 



Low Level Left Floppy Configuration 



A 




Number of sides 


2 


B 




Number of cylinders 


80 


C 




Sectors per track 


8 


D 




Bytes per Sector 


512 


E 




Retries 


10 


F 




Motor on delay factor 


9600 


G 




Data length 


255 


H 




Gap 3 parameter 


42 


I 




Gap 3 for format 


80 


J 




Pattern for format 


229 


K 




Skew for format 


0 


L 




IBM track format 


Off 


M 




NCI 10 sects/trk 


Off 


N 




Read 48 on 96 TPI 


Off 


0 




Read after write 


On 


P 




Ignore errors 


Off 



Select item to change (CR to quit) 



'A' asks for 0, 1 or 2 sides for the diskette. Zero should be specified 
if the drive is not equipped. This will return an early error without 
having to go through a timeout process. 

'B' asks for the number of cylinders on the diskette. Cylinders and 
tracks are often used in the same context. A cylinder represents a head 
position which may access a track on each side of a double sided 
diskette. 

'C asks for the number of sectors per track. Typical values are 8 for 
512 byte sectors or 16 for 256 byte sectors. Note that the Gap 3 
parameter and the Gap 3 for formatting also must be modified for a 
specific Sectors per Track and Bytes per Sector combination. Also the 
density selection interacts with all these parameters. 
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'D' asks for the number of bytes per sector. Typically this is 512 for 
8 sectors per track or 256 for 16 sectors per track. Note that the Gap 
3 parameter and the Gap 3 for formatting also must be modified for a 
specific Bytes per Sector, Sectors per Track and density combination. 
Note also that selections of Bytes per Sector above 512 are not 
currently supported. 

'E' asks for the number of retries. This question should be answered 
with the number of retries that the diskette driver should make before 
returning an error. The system is normally shipped with 3 retries 
specified but this may be increased to attempt to access data on a 
marginal diskette. 

'F' asks for the Motor on delay factor. This should be given in 
hexadecimal as the number of 1/64000 ths of a second for the delay. 

'G' asks for Data Length. This parameter is only used by the controller 
when the sector size is less than 256 bytes per sector. In these cases 
the Data Length is the number of bytes per sector (typically 128). For 
all other cases the Data Length is normally set to 255. 

'H' asks for the Gap 3 parameter (in decimal). This parameter is 
required by the controller for Read and Write commands to avoid the 
splice point between the data field and the ID field of contiguous 
sectors. The value depends on the combination of Bytes per Sectors, 
Sectors per Track, and density selection. Suggested values from the 
controller documentation are: 

Gap 3 for format 



Density 


BPS 


SPT 


Gap 3 


Gap 


Single 


128 


18 


7 


9 




128 


16 


16 


25 




256 


8 


24 


48 




512 


4 


70 


135 


Double 


256 


18 


10 


12 




256 


16 


32 


50 




512 


8 


42 


80 



'I' asks Gap 3 for formatting. Values for this parameter are used when 
formatting a diskette and are contained in the Gap 3 table under 
selection 'H' . 

'J' asks for a Pattern for formatting. This value (0 to 255) is written 
into each data byte during the formatting of a diskette. The normal 
default value is 229 (E5 hex) . Note that certain operating systems 
(such as CP/M) may require a specific format pattern. 
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*%' asks for a Skew factor. This value is normally zero. The 10 sector 
per track formats generally specify a two sector skew to be formatted 
onto the diskette. This improves the performance when accessing the 
diskette over track boundaries. The IBM format is normally identical to 
the standard SAGE 8 sector per track format as the difference is only in 
where the data is written. On 10 sector per track diskettes with IBM 
format, the skew is reversed for head one because the tracks are 
accessed in decreasing order. The special NCI format also requires use 
of the IBM format selection. 

'L' sets the IBM track format compatibility on or off. For double sided 
diskettes, data is stored in ascending track order on side zero and then 
back in descending track order on side one. The normal SAGE IV method 
is to store data on side zero and then side one of each track before 
stepping the head to the next cylinder. 

'M' will set the option to use a special sector numbering scheme 
developed by Network Consulting Incorporated. This scheme was 

implemented by NCI for their BIOS on the IBM Personal Computer. It 
allows their software to automatically distinguish between their 10 
sector per track diskettes and the normal 8 sector per track IBM 
standard diskettes. Sectors are numbered from 9 to 18 (except the first 
sector on the device which is numbered 1). 

'N' controls the feature which allows reading of 48 TPI diskettes on a 
96 TPI drive. Note that writing from a 96 TPI drive to a 48 TPI 
diskette is not allowed because the 48 TPI drives cannot read the data. 
The 96 TPI drive is stepped two physical tracks for every track normally 
requested by the driver. 

'0' controls the option to perform a read of information from sectors 
which have just been written. This Read after Write feature verifies 
that the controller can read back the information without detectable 
errors. This option slows down the writing process but should be left 
enabled to insure valid operation. 

'P' controls the option to ignore errors from the floppy controller. 
The controller errors should never be ignored in normal operation. This 
option is only provided to allow a head alignment procedure to be 
performed using a special alignment diskette which contains unreadable 
data. The driver must continue to read the diskette so that signals may 
be observed with test equipment, even though the controller is detecting 
errors. 
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IV. 08. 03 Shared Floppy Configuration 

These parameters are shared by the two floppies as they are set in 
the same controller. This means that the change will effect BOTH 
floppies and care should be taken to verify that this is really 
what the user wants. 



'A' asks for the Step Rate. This is the number of milliseconds allowed 
between head step pulses by the controller. The value may be varied 
between 2 to 32 milliseconds (only even number values are supported). 

'B' or 'C is not advised. These parameters are set by the factory and 
should not be modified. 

'D' will set the density option. The drives provided on the SAGE IV 
will normally be used in the double density mode. The single density 
option (Off) should only be required to access data from another system 
which provides only single density drives. The Sectors per Track, Bytes 
per Sector, and Gap 3 values must all be coordinated with the density 
selection. 



Shared Low Level Floppy Configuration 



A 
B 
C 
D 



Step Time (msec) 
Head load 
Head unload time 
Double Density 



2 
3 
1 

On 



Select Menu item <CR exits>: 
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IV. 08. 04 Winchesters #1 - #4 Configuration 

The low level Winchester configuration allows the format to be changed 
for different types of drives. Normally this is only done by the 
factory or service centers. 

Winchester #1 Parameters 



A 




Number of Cylinders 


o r\ c 


D 




Bytes per sector 


SI 9 

J Li. 


c 




Step Time 


192 


D 




Slew Time 


20 


E 




Step Counter 


32 


F 




Head Settle Time 


1216 


G 




Cylinder for Precomp 


306 


H 




Special types 


0 


I 




Test flags 


0 


J 




Track for shipping 


329 


K 




Low Read Counter 


1100 


L 




High Read Counter 


1140 


M 




Header Count 


400 


N 




Number of Heads 


4 


0 




Number of Retries 


10 


P 




Sectors per Track 


19 


Q 




Select Bit 


1 



Select Menu item <CR exits>: 
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IV. 08. 05 Operating System Information 

J. . .Operating System Information 

When you use the 'J' option the system will display: 

CPM system configuration 
A - Number of Disk Buffers 3 B - Disk Buffer Size 4096 



c 




Disk 


Drive 


A 


D 




Disk 


Drive 


B 


E 




Disk 


Drive 


C 


F 




Disk 


Drive 


D 


G 




Disk 


Drive 


E 


H 




Disk 


Drive 


F 


I 




Disk 


Drive 


G 


J 




Disk 


Drive 


H 


K 




Disk 


Drive 


I 


L 




Disk 


Drive 


J 


M 




Disk 


Drive 


K 


N 




Disk 


Drive 


L 


0 




Disk 


Drive 


M 


P 




Disk 


Drive 


N 


Q 




Disk 


Drive 


0 


R 




Disk 


Drive 


P 


S 




Physical Chai 



Offset: 2, 
Offset: 2, 
Offset: 1, 
Offset: 1, 
Offset: 2, 
Offset: 1, 
Drive not 
Drive not 
Drive not 
Drive not 
Drive not 
Drive not 
Drive not 
Drive not 
Drive not 
Drive not 



Entries: 64, Block size: 2048, 
Entries: 64, Block size: 2048, 
Entries: 256, Block size: 4096, 
Entries: 256, Block size: 4096, 
Entries: 64, Block size: 2048, 
Entries: 256, Block size: 4096, 

configured in channel 

configured in channel 

configured in channel 

configured in channel 

configured in channel 

configured in channel 



configured 
configured 
configured 
configured 
■ation T 



Block size: 
Block size: 
table 
table 
table 
table 
table 
table 
table 
table 
table 
table 



Removable 

Removable 

Fixed 

Fixed 

Removable 

Fixed 



in channel 
in channel 
in channel 
in channel 
- Auto Start Command: 



*** None Defined 



Select Menu item <CR exits>: 



A. . .Number of Disk Buffers 

Typing 'A' from the menu will allow you to change the number of 1/0 
buffers. The screen displays: 

Enter number of I/O buffers (1 - 16)? 
Enter the number of I/O buffers wanted. A maximum of 16 are 
allowed. 

B . . .Disk Buffer Size 

Typing 'B' from the menu will allow you to change the buffer size. 
The screen displays: 

Enter buffer size in bytes 
Enter the buffer size in bytes (the buffer size should be a track 
size). It will be rounded off to within 512 bytes. The maximum 
length is 16384 bytes and the minimum length is 512. 
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C-R.DJLsk Drive x: 

Typing C - R in the menu will let you change the disk drive 
configuration. The only drives you can configure are the ones that 
have been entered in the channel table, the entries will say Not 
Configured instead of Drive not configured in channel table. You 
can set up the configuration for drives A through P. You cannot 
alter the drive configuration on-line, but you can view them. 
Changes made on-line will have no. effect as they will not be 
updated. 

The RAM Disk is always considered fixed and has a track offset of 
zero. 

Once you made a selection the system will respond: 

A - Logical block size: 1024 C - Number of directory entries: 0 

B - Directory track offset: 0 D - Disk media: Fixed 

Select Menu item <CR exits>: 



Typing A - D selects the corresponding subgroup as follows: 

A. ..Block size (1024,2048,4096,8102,16384)? 

This is the logical block size used by CP/M 68K for disk 
allocation. 

B . . .Directory offset (0-7) tracks 

This is the track where the directory starts, track 2 if floppy and 
1 if 

Winchester partition. 

C. .. Number of directory entries? 

This is the number of entries in the directory. The number must be 

an even multiple of 32 (32,64,96...). Any other number will be 
decreased 

to the nearest multiple of 32. 

D. .. Fixed or Removable 

This switches the disk type from fixed to removable media and visa 
versa. 
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S... Physical channel configuration 

Typing 'S' in the menu will allow you to change the system and 
channel data. This data is also changed by using the above option 
which is much safer. When you type 'S' the system will display: 

Physical channel configuration 
A - System configuration 
B - Physical channel system configuration 
C - Winchester #1 system configuration 
D - Winchester #2 system configuration 
E - Winchester #3 system configuration 
F - Winchester #4 system configuration 

Select Menu item <CR exits>: 



< 
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..System configuration 

Typing an 'A' will enable you to change the system configuration. 
This 

information relates to disk buffers and the Ram disk. The system 
will 

display: 



Configuration 



A 




System 


Data[ 


0]: 


0802 


B 




System 


Data| 


1] 


2100 


C 




System 


Data[ 


2]: 


0000 


D 




System 


Data| 


3] 


: 0000 


E 




System 


Data| 


4]: 


0000 


F 




System 


Data! 


5] 


: 0000 


G 




System 


Data| 


6]: 


0000 


H 




System 


Data| 


7] 


: 0000 


I 




System 


Data| 


8]: 


0000 


J 




System 


Data! 


9] 


: 0000 


K 




System 


Data| 


10] 


0000 


L 




System 


Data! 


11] 


: 0000 


M 




System 


Data! 


12] 


0000 


N 




System 


Data' 


13] 


: 0000 


0 




System 


Data! 


14] 


: 0000 


P 




System 


Data! 


15] 


: 0000 



'A' represents the disk buffer size and number of disk buffers. The 
08 is the buffer size/512 and the 02 is the number of disk buffers - 1= 
'B' is the configuration of the Ram disk. The word has the following 
format: 

Bits 00 - 03: Flags 

Bit 0: 1 = Removable, 0 = Fixed Media 

Bit 1: Unused 

Bit 2: Unused 

Bit 3: Unused 
Bits 04 - 06: Directory offset (0-7 tracks) 
Bits 07-12: Number of directory entries / 32 

Bits 13-15: Block size (0 - IK, 1 - 2K, 2 - 4K, 3 - 8K, 4 - 16K) 

This information corresponds to the information in the CPM system 
configuration menu. All changes should be made through the CPM system 
configuration menu. 
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B... Physical channel configuration 

Typing 'B' enables you to change the physical channel configuration. 
The information in the table corresponds the floppy disk drive. The 
table is displayed as follows: 



Configuration 



A 




Physical 


Channel 


Data 


: 1] 


: 0000 


B 




Physical 


Channel 


Datal 


2] 


0000 


C 




Physical 


Channel 


Data 


: 3] 


: 0000 


D 




Physical 


Channel 


Datal 


4] 


2121 


E 




Physical 


Channel 


Data' 


5] 


! 2121 


F 




Physical 


Channel 


Datal 


6] 


0000 


G 




Physical 


Channel 


Datal 


7] 


\ 0000 


H 




Physical 


Channel 


Datal 


8] 


0000 


I 




Physical 


Channel 


Datal 


9] 


: 0000 


J 




Physical 


Channel 


Datal 


10]< 


0000 


K 




Physical 


Channel 


Datal 


11] 


: 0000 


L 




Physical 


Channel 


Datal 


12]« 


0000 


M 




Physical 


Channel 


Datal 


13] 


: 0000 


N 




Physical 


Channel 


Datal 


14]: 


0000 


0 




Physical 


Channel 


Datal 


15] 


: 0000 


P 




Physical 


Channel 


Datal 


16]: 


0000 



The word layout in this table has the same format as explained above. 
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C-F .Winchester system configuration 

Typing 'C - I* will enable you to change the Winchester configuration 
for the particular disk. Each word in the display represents a 
partition on the selected Winchester disk. The system displays the 
following: 



A 

A 




Winchester 


It I 


Data | 


n l . 
U J 


uuuu 


x> 

D 




Winchester 


if 1 


Data [ 


1 1 « 
l J • 


nnno 


c 




Winchester 


#1 


Data! 


2] 


0000 


D 




Winchester 


#1 


Data[ 


3): 


0000 


E 




Winchester 




Dataj 


4] 


: 0000 


F 




Winchester 


#i 


Data[ 


5]: 


4410 


G 




Winchester 


#i 


Data| 


6] 


: 4410 


H 




Winchester 


#i 


Datal 


7] 


4410 


I 




Winchester 


#i 


Data| 


8] 


: 0000 


J 




Winchester 


#i 


Data! 


9] 


0000 


K 




Winchester 


#i 


Data! 


10] 


: 0000 


L 




Winchester 


#i 


Datal 


11] 


: 0000 


M 




Winchester 


#i 


Data 


12] 


: 0000 


N 




Winchester 


#i 


Data! 


13] 


: 0000 


0 




Winchester 


#i 


Data! 


14] 


: 0000 


P 




Winchester 


#i 




15] 


: 0000 



The word layout is the same as explained above. 



NOTE: The information in the above system configuration items should only 
be changed in the CPM system configuration menu. 

T. . .Auto Start Command 

Typing 'T' will enable you to give the system a command line to be 
executed on boot. The command can be up to 16 characters. You can 
have it execute a submit file to do a number of things on boot. 
When you type 'T' the screen will respond: 

Start command (16 character ,*=none) : 

At this point type in whatever you want executed on start up. 
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V CP/M-68K memory configuration 



CP/M-68K, Sage BIOS, RAM Disk (if configured) and the Disk I/O buffers 
reside at the top of the available memory. The TPA starts at 400 hex 
(1024 decimal) and ends just below the CP/M-68K area. The following 
diagram illustrates the memory layout: 



Top of memory ********************************************* 



* * 

* Sage BIOS * 

* * 

* * 

* CP/M-68K & BIOS Interface * 

* * 
* , — , .« ; * 

* * 

* Disk I/O Buffers * 

* * 
* * 

* 

* * 

* RAM Disk (if configured) * 

* * 

* * 

* * 

* * 

* Transient Program Area (TPA) * 

* * 

* * 

400 hex * - * 

* * 

* Exception Vectors * 

* * 

0 hex ********************************************* 
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VI Sage CP/M-68K Bootstrap loader (BOOT.S) 



There are several differences between the standard release and the Sage 
release of the CP/M-68K bootstrap procedure. These differences are in 
the CP/M-68K bootstrap loader and the BIOS initialization routine. 

The CP/M-68K bootstrap loader resides in the boot area of the disk at 
track 0. The PROM boot routine loads IK of the bootstrap from disk to 
address 400 hex in memory and starts the bootstrap execution. The boot 
disk must be configured to support a logical block size of 2k blocks. 
The disk size itself must not be less than 257 blocks. The directory 
size and the directory offset are configurable by SAGEUTIL. 

Once loaded, the bootstrap loads another lk of code which is its own 
extension code. Then it reads the directory of the boot floppy and 
searches for the files SAGEBIOS.SYS and CPM.SYS. The positions of 
CP/M-68K.SYS and SAGEBIOS.SYS are found on the disk. Note: these files 
should be the first ones transferred to the disk when it is built so 
that they will load faster. 

SAGEBIOS.SYS is loaded into the top of memory (see map). 

The buffers areas are allocated in memory after SAGEBIOS. 

CPM.SYS is loaded into memory just after the buffer areas. 

The relocation data in read in to the TPA and the necessary address 
relocation is done for CP/M. 

Control jumps to the beginning of CP/M. A program call _INIT starts. 
_INIT does the following: 

Allocates the disk I/O buffers 

Allocates the RAM Disk area if RAM Disk is configured 
Checks the size of TPA. 

If the TPA is larger than the available space, RAM Disk is 
automatically de-allocated to provide room. If there is still not 
enough room, the number of disk I/O buffers are reduced. At least 
one buffer will always be left. The Data in the TPA area is lost 
when CP/M-68K is rebooted from disk. 

At this point the 'Sign-on' message appears: 

CP/M-68K 1.1 (xxx TPA) 
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VII RAM Disk 



RAM Disk is an optional area of RAM that is configured to look like a 
disk. It provides very fast temporary "disk" storage. It can provide a 
temporary file medium for the C compiler or the 68000 assembler. 

RAM Disk will remain until CP/M-68K is rebooted. The PROM boot supports 
commands (IFR, IFRO, IFR1 etc.) to re-boot without clearing the RAM 
Disk contents but these commands are not currently implemented for CP/M. 

RAM Disk is controlled exactly as the other disks used in the system 
except that RAM Disk does not use the disk I/O buffers and therefore 
does not need to be flushed. The BIOS interface contains the routines 
to drive RAM Disk. Requests can be made directly to the BIOS. 

The RAM Disk size is configured by setting the TPA size, the disk I/O 
buffer size and the number of disk I/O buffers. RAM Disk is contained 
in the remaining memory. RAM Disk is considered drive E: when it is 
configured. RAM Disk cannot be re-configure on-line. 

RAM Disk configuration control is supported in SAGEUTIL (Sage's utility 
routine) . 
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VIII Sage CP/M-68K BIOS Interface (BIOS.S) 



The Sage BIOS contains the low level drivers for the disks, console, and 
printer. It is a memory image, location independent file which resides 
at the top of memory. Section X of Volume 1 of the SAGE Users' Manual 
describes the BIOS calls which are "TRAP" entry points. 

The BIOS interface accepts BIOS requests from the BDOS or user programs 
and resolves them by calling Traps 9 - 15 to the Sage BIOS. 

The BIOS interface uses the configuration information contained in the 
Sage BIOS to setup the disks for CP/M-68K. When a disk is selected for 
the first time, configuration information in the Sage BIOS is retrieved 
to generate the CP/M- 68K configuration data. See the section on 
SAGEUTIL for information on how to change the configuration. 

The BIOS disk I/O buffers are used to convert the floppy format to the 
internal disk format of 128 byte sectors. The buffers also provide 
higher disk throughput. The buffer size should not be allocated larger 
than the track size of the disk. No matter how large the buffer size 
is, the maximum transfer size is limited to a track. Increasing the 
number of buffers however, can be used to enhance system throughput. 
The more buffers there are greater the amount of disk data kept in 
memory. 

The BIOS uses a LRU (Least Recently Used) buffering scheme. The buffer 
which has been idle for the longest amount of time is used for current 
disk request. This enhances system throughput but can cause strange 
results if care is not taken when floppies are swapped. Always enter a 
CNTRL-C to "warm boot" the system when exchanging floppies. 

After PIP is loaded into memory from the source disk, the disk can be 
replaced with another disk and a file transferred from that source 
without any problems. Changing the destination disk is not advised. 
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IX CP/M-68K and Boot Generation 
IX. 01 COPYING A BOOT 

Normally you will not have to generate a boot. The SAGEUTIL BOOT COPY 
program will allow you to copy an existing boot from another diskette. 
Then using PIP copy the CPM.SYS and SAGEBIOS.SYS from the current boot 
disk to the new boot disk. 
EXAMPLE: 

A>SAGEUTIL 

C(onfigure, Boot copy, F(ormat, Q(uit? 

Type B and a carriage return to enter the Boot copy routine. 

Bootstrap Copy Utility 

Source file or device <just CR quits> ? 

Type a: to load the boot file. 

Destination file or device <just CR quits> ? 

Type b: to store the boot file on the new disk. 
Exit Sage utility routine. 

A>pip b:=a:sagebios .sys 
B>pip b:=a:cpm.sys 

The new disk is now bootable. 
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IX. 02 BUILDING A NEW BOOT 

The generation of the bootstrap loader (BOOT.68K) is accomplished with 
these steps: 

1. First assemble the program BOOT.S to create the object file. 
A>as68 -n boot.s 



2. Link the object file to run at address 400 in memory. 
A>lo68 -t400 -o boot. 68k boot.s 



3. Use SAGETUTIL to copy the binary file into the boot area. 
This is track 0, blocks 0-4 of the diskette. 

A>SAGEUTIL 

C(onfigure, Boot copy, F(ormat, Q(uit? 

Type B and a carriage return to enter the Boot copy routine. 

Bootstrap Copy Utility 

Source file or device <just CR quits> ? 

Type boot. 68k to load the boot file. 

Destination file or device <just CR quits> ? 

Type b: and a carriage return to write the loader to the 
destination disk. 

Quit SAGEUTIL as the new bootstrap has been loaded on the 
destination floppy. 



NOTE: Earlier releases of SAGEUTIL. C request the starting track 
(standard value =2) and the number of directory entries (64). The 
current version obtains the directory, track and blocking information 
from the BIOS configuration of the destination floppy drive. 
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IX. 03 BUILDING CP/M-68K 

In the SAGE version of CP/M-68K, the relocation bits are maintained in 
the CP/M-68K system file (CPM.SYS). Both the CP/M-68K file and the 
SAGEBIOS are stored in the user area of the boot disk. 

CP/M-68K is generated with these steps: 

The BIOS file is assembled producing an object file (BI0S.0). 
A>as68 -1 bios.s 

This file is linked with the CP/M-68K library (CPMLIB) producing a 
relocatable CP/M-68K system file called CPM.REL. 



A>lo68 -r -ucpm 




CPM.REL and SAGEBIOS. SYS are c 



to the new boot disk. 



A>pip b:cpm.sys=a:cpm.rel 



CPM.REL is copied as CPM.SYS. 



A>pip b: =a : sagebios .sys 
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X Compiling a C Program 



In order to compile a C program you will need the following programs on 
one disk: 



Your source C program 
CP68.68K - The C preprocessor. 
C068.68K - The C parser. 
C168.68K - The C code generator. 
C.SUB - Submit file to do a C compile. 

CLINK. SUB - Submit file to link a C program. 
S.O - Startup routine for C programs. 

UNITIO.O - I/O routines for the SAGE if use 
CLIB - The C run- time library. 




i your program. 



Type 



the following to initiate the compile: 



C filename <CR> 



When you type in your filename do not put on a .C because the submit 
file assumes it is a .C file. After the compile is done successfully 
you must then link the resulting object file to S.O, any other object 
files and CLIB. To do this type: 

CLINK filename <CR> 

Again do not put the .0 onto the filename, the submit file assumes .0. 
The resulting file will be a .68K file. 

C.SUB has the following entries to be executed: 

CP68 $1.C $1.1 

C068 $1.1 $1.IC $1.ST 

ERA $1.1 

ERA $1.ST 

C168 $1.IC $1.S -L 

ERA $1.IC 

AS68 -L -U $1.S 

ERA $1.S 

The $1 represents your filename. The disk is cleaned up after each item 
is done by the ERA command. If you have problems with your program you 
might want to save the source so you might want to take out the ERA $1 .S 
command • 
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If you run out of disk space during a compile or you are compiling a 
large file you should change C.SUB to put the work files on B: disk as 
follows : 

CP68 $1.C b:$l.I 

C068 b:$l.I b:$l.IC b:$l.ST 

ERA b:$l.I 

ERA b:$l.ST 

C168 b:$l.IC b:$l.S -L 

ERA b:$l .IC 

AS68 -F b: -L -U b:$l.S 
ERA b:$l.S 

The -F b: option in the assembler indicates that temporary files are to 
be created on drive B:. 

CLINK. SUB has the following entry to be executed: 

L068 -r -o $1.68K s.o $l.o $2.o $3.o $4.o $5.o $6.0 $7.o $8.0 $9.o 

The $1 represents your filename. S.O is the startup program, $2 through 
$9 are the names of object files to linked with your file and CLIB is 
the C library. The linker directive -r makes the file relocatable. If 
you do not want your program to be relocatable change CLINK. SUB and use 
-taddress as explained in the CP/M-68K Programmer's Guide in the section 
on the Linker. 
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